Skip to content

feat(onboarding): Scaffold SCM onboarding steps with placeholder UI#110747

Merged
jaydgoss merged 4 commits intomasterfrom
jaygoss/vdy-18-add-feature-flag-and-scaffold-scm-onboarding-steps-with
Mar 17, 2026
Merged

feat(onboarding): Scaffold SCM onboarding steps with placeholder UI#110747
jaydgoss merged 4 commits intomasterfrom
jaygoss/vdy-18-add-feature-flag-and-scaffold-scm-onboarding-steps-with

Conversation

@jaydgoss
Copy link
Member

Scaffold the frontend onboarding step array for the SCM-first onboarding flow behind the organizations:onboarding-scm feature flag. When enabled, the onboarding shows 5 steps instead of the legacy 3, with placeholder components for each new step that just render a heading and Continue button.

The feature flag was registered in #110570. This PR adds the frontend wiring:

  • Three new OnboardingStepId enum values (SCM_CONNECT, SCM_PLATFORM_FEATURES, SCM_PROJECT_DETAILS)
  • Conditional step array selection based on the feature flag
  • Placeholder step components (ScmConnect, ScmPlatformFeatures, ScmProjectDetails)
  • Extended OnboardingContext with selectedIntegration, selectedRepositories, and selectedFeatures state (session storage backed)
  • Updated useBackActions to accept onboardingSteps as a parameter instead of importing the now-conditional module-level constant
  • Fixed goNextStep to allow navigation to SETUP_DOCS when platform is set via context (needed for the SCM flow where platform selection happens in an earlier step)
  • Replaced fragile index-based step lookups (onboardingSteps[2]) with OnboardingStepId enum references

With the flag off, behavior is unchanged (existing tests all pass).

Refs VDY-18

Add conditional onboarding step array behind the onboarding-scm feature
flag. When enabled, the flow shows 5 steps (Welcome, Connect Repository,
Platform & Features, Project Details, Install SDK) instead of the
legacy 3 steps.

- Add SCM_CONNECT, SCM_PLATFORM_FEATURES, SCM_PROJECT_DETAILS step IDs
- Create placeholder step components with heading and Continue button
- Extend OnboardingContext with selectedIntegration, selectedRepositories,
  and selectedFeatures state backed by session storage
- Pass onboardingSteps as parameter to useBackActions instead of importing
- Fix goNextStep to allow platform from context for SCM flow
- Replace fragile index-based step lookups with OnboardingStepId enum refs

Refs VDY-18
Co-Authored-By: Claude Opus 4.6 <noreply@example.com>
@linear-code
Copy link

linear-code bot commented Mar 16, 2026

@github-actions github-actions bot added the Scope: Frontend Automatically applied to PRs that change frontend components label Mar 16, 2026
@jaydgoss jaydgoss marked this pull request as ready for review March 16, 2026 16:47
…dk test

The OnboardingContext type now requires setSelectedIntegration,
setSelectedRepositories, and setSelectedFeatures. Add these mock
functions to satisfy the type checker.

Co-Authored-By: Claude Opus 4.6 <noreply@example.com>
Verify the flag-gated SCM onboarding flow navigates correctly through
all 5 steps: welcome -> scm-connect -> scm-platform-features ->
scm-project-details -> setup-docs. Also covers back navigation,
the setup-docs guard requiring a platform selection, and redirect
of legacy step URLs to welcome when the SCM flag is on.

Co-Authored-By: Claude Opus 4.6 <noreply@example.com>
…SCM flow

Redirect deep-links with invalid platforms to the SCM_PLATFORM_FEATURES
step when the SCM flag is on, instead of SELECT_PLATFORM which does not
exist in the SCM step array.

Preserve SCM context state (integration, repositories, features) when
clearing the selected platform. Previously removeOnboarding() wiped the
entire session storage key. Now only perform a full reset when no other
SCM state remains.

Co-Authored-By: Claude Opus 4.6 <noreply@example.com>
@jaydgoss jaydgoss marked this pull request as ready for review March 16, 2026 17:16
@jaydgoss jaydgoss requested a review from a team March 16, 2026 17:16
@jaydgoss jaydgoss merged commit 3d27762 into master Mar 17, 2026
62 checks passed
@jaydgoss jaydgoss deleted the jaygoss/vdy-18-add-feature-flag-and-scaffold-scm-onboarding-steps-with branch March 17, 2026 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Scope: Frontend Automatically applied to PRs that change frontend components

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants